home *** CD-ROM | disk | FTP | other *** search
/ Developer CD Series 1990: Night of the Living Disc / Night of the Living Disc.hdv / Dev.CD.5 / Tools / Technical.Notes / GSOS / TN.GSOS.006 < prev    next >
Encoding:
Text File  |  1989-07-21  |  2.3 KB  |  50 lines  |  [04] ASCII Text (0x0000)
  1. Apple II
  2. Technical Notes
  3. _____________________________________________________________________________
  4.                                                   Developer Technical Support
  5.  
  6.  
  7. GS/OS
  8. #6:    Drivers and GS/OS Direct Page
  9.  
  10. Revised by:    Dave Lyons                                           July 1989
  11. Written by:    Matt Deatherage                                     March 1989
  12.  
  13. This Technical Note corrects an error in the preliminary GS/OS documentation 
  14. and provides an alternate suggestion for developers who are writing GS/OS 
  15. drivers.
  16. Changes since March 1989:  Added information about setting the D register 
  17. before making system service calls and documented that the GS/OS direct page 
  18. is now guaranteed to remain the same between Driver_StartUp and 
  19. Driver_ShutDown calls.
  20. _____________________________________________________________________________
  21.  
  22. Preliminary GS/OS documentation, including the beta draft of GS/OS Reference, 
  23. Volume 2, incorrectly states that locations $5A through $5F are available for 
  24. device drivers, and that locations $66 through $6B are shared by device 
  25. drivers and supervisory drivers (and may be corrupted by either a driver or 
  26. supervisory driver call).
  27.  
  28. This is not correct.  The locations in question are used by GS/OS; destroying 
  29. these locations can cause system failure and media corruption.
  30.  
  31. Drivers which require direct page space of their own should request it from 
  32. the Memory Manager when they are started.  Upon receiving a call, a driver can 
  33. save the value of the D register (containing the GS/OS direct page) and switch 
  34. to its own direct page.  The driver may keep the value of its direct page 
  35. inside the driver itself; no space on GS/OS direct page is available for this 
  36. purpose.  The driver must restore the D register to point to the GS/OS direct 
  37. page before returning from the call, and it should also dispose of its direct 
  38. page space when it shuts down.
  39.  
  40. The driver must also set the D register to point to the GS/OS direct page 
  41. before making any system service call other than SET_SPEED and 
  42. DYN_SLOT_ARBITER.
  43.  
  44. Note:  The location of the GS/OS direct page is guaranteed to 
  45.        remain the same between Driver_StartUp and Driver_ShutDown calls.
  46.  
  47.  
  48. Further Reference
  49. _____________________________________________________________________________
  50.     o    GS/OS Reference, Volume 2